PATHHardware Documentation > USB Devices > Mac OS USB DDK API Reference

USBClearPipeStallByReference

The USBClearPipeStallByReference function clears a stall on the specified pipe. This call can only be used on a pipe, not on a device's default pipe 0.

--> ref

Pipe reference.

All outstanding transactions on the pipe are returned with a kUSBAborted status. The pipe status is set to active; if the pipe was previously idle it is set back to idle. The stalled state is cleared, idle is not.

A call to this function does not clear a device's endpoint stall. The class driver has to take care of that by using USB standard device commands, such as CLEAR_ENDPOINT_STALL . The class driver may need to take other remedial actions.

After this function is called, the device's endpoint needs to be synchronized with the host's endpoint. See Data Toggle Synchronization for information about how to accomplish endpoint data toggle synchronization.

Errors returned by the USBClearPipeStallByReference function include:

Previous | Back Up One Level | Next | Show Frames | Hide Frames